feat: add document classification pipeline#6
Merged
caio-pizzol merged 2 commits intomainfrom Mar 9, 2026
Merged
Conversation
Python ML pipeline (scripts/classification/) that classifies ~800K .docx documents by document type (10 classes) and topic (9 classes) using the FineWeb-Edu pattern: LLM labels a sample → train ModernBERT → apply at scale. Pipeline steps: - sample.py: stratified sampling across languages and word count - label.py: async LLM labeling with Claude (resumable) - train.py: fine-tune two ModernBERT classifiers - classify.py: batch inference on full corpus - evaluate.py: quality metrics and distribution analysis Also adds: - LLM classification fields and methods to DbClient - CLAUDE.md / AGENTS.md at root, packages/shared, and scripts/classification - Updated README with Phase 5 (Classify) and project structure
Welcome to Codecov 🎉Once you merge this PR into your default branch, you're all set! Codecov will compare coverage reports and display results in all future pull requests. ℹ️ You can also turn on project coverage checks and project coverage reporting on Pull Request comment Thanks for integrating Codecov - We've got you covered ☂️ |
- Merge train_modal.py into train.py (--modal flag) - Merge classify_modal.py into classify.py (--modal --workers N) - Switch base model to xlm-roberta-base (multilingual) - Add class-weighted loss for imbalanced classes - Add --exclude flag to sample.py for iterative sampling - Gitignore models/ and *.jsonl artifacts - Update docs for Modal setup and cost estimates
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Python ML pipeline (scripts/classification/) that classifies ~800K .docx documents by document type (10 classes) and topic (9 classes) using the FineWeb-Edu pattern: LLM labels a sample → train ModernBERT → apply at scale.
Pipeline steps:
Also adds: